home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / vuimg260.exe / VUIMG.DOC < prev    next >
Text File  |  1990-09-15  |  31KB  |  715 lines
  1.                   VUIMAGE(tm) (Version 2.60) (Shareware)
  2.                 GIF*/TIFF Format Picture Displayer/Printer
  3.         Copyright (C) 1990 Offe Enterprises. All rights reserved.
  4.  
  5.                                 USERS MANUAL
  6.  
  7.  Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  8.                                 708-357-6679
  9.  
  10. ===============================================================================
  11. Additions/Changes from the previous version (V2.53):
  12.   - Now supports printing of images.  To choose printer, use the Options menu.
  13.        Print entire image, set your own print size.
  14.   - Now can dither images in 2-color display modes - none, 2x2, 3x3, 4x4
  15.        dithering
  16.   - Dither print output - none, 2x2, 3x3 or 4x4 dithering
  17.   - better Options menu
  18.   - reads more TIFF files
  19.   - memory requirement has increased to 150K
  20.  
  21. Additions/Changes from the previous version (V2.42):
  22.   - drivers for Trident, Video-7 1024i and Video-7 VRAM cards added
  23.   - select files using cursors, mark/unmark for list of files
  24.   - read more TIFF files - Vuimage Plus(tm) now supports PackBits
  25.     compressed bilevel TIFF files
  26.  
  27. Additions/Changes from the previous version (V2.3):
  28.   - user selectable screen colors ("-cd/-co/-cg/-cm" commandline options).
  29.   - Automatic video mode selection capability - a mode suitable for the
  30.     picture will be selected automatically.  Detects CGA/Hercules/EGA/VGA
  31.     adapters and enables appropriate modes (user can still specify a
  32.     particular video mode).
  33.   - provides drivers for Everex 678, Video-7 Fastwrite
  34.   - 800x600x16 mode support for standard IBM VGA adapter
  35.   - video drivers have been re-named
  36.   - Changed pan step to 1/8 screen for TIFF files only
  37.  
  38. ===============================================================================
  39.  OTHER PROGRAMS AVAILABLE FROM OFFE ENTERPRISES:
  40.  
  41.    TBG(tm)     - TIFF black&white/grayscale image to GIF/TIFF black&white/
  42.                  grayscale converter (can reduce large b&w images to smaller
  43.                  grayscale ones, convert TIFF to GIF etc.)
  44.    SCRtoPS(tm) - Dump text and graphics screens (CGA/EGA/VGA) to PostScript*
  45.                  printer or capture to Encapsulated PostScript file (including
  46.                  line/box characters).  Requires only about 10K of resident
  47.                  memory.
  48.  
  49.    See file PROGRAMS.DOC for more information on these programs.
  50. ===============================================================================
  51.  
  52. *  GIF and "Graphics Interchange Format" are trademarks (tm) of Compuserve,
  53.    Inc., an H&R block company.  PostScript is a trademark of Adobe Systems, Inc.
  54.    VUIMAGE, VUIMAGE PLUS, TBG and SCRtoPS are trademarks of Offe Enterprises.
  55.  
  56.  
  57.  
  58. INTRODUCTION
  59.  
  60. Offe is proud to bring you our GIF/TIFF display software for the IBM PC family.
  61. Its main features are:
  62.  
  63.     - super fast display of GIF files and bilevel/grayscale TIFF files
  64.     - print GIF and TIFF files (four dithering options)
  65.     - print entire image, set your own print size
  66.     - requires only 150K of free memory to run
  67.     - supports a variety of display types - CGA/Hercules/6300/DEB/EGA/MCGA/
  68.       VGA/SuperVGA
  69.     - 320x400x256, 360x480x256 and 800x600x16 driver for standard IBM VGA
  70.     - excellent color rendition in all video modes
  71.     - four dithering options for two-color video modes
  72.     - handles large images
  73.     - automatic/manual video mode selection capability
  74.     - auto/manual scaling - automatically scale to full screen or
  75.       manually scale from 1% to 999%
  76.     - zoom in / zoom out using the "+" and "-" keys
  77.     - panning - cursor keys allow moving screen window over different sections
  78.       of picture 
  79.     - adjust brightness while picture is on screen
  80.     - supports other boards/future boards through BIOS mode
  81.     - user-friendly, multiple interfaces
  82.         - menu-selectable options
  83.         - command-line selectable options (useful in batch files and when
  84.           called as a sub-program by other programs)
  85.         - pre-programmed keystroke mode (std. input re-direction)
  86.     - select files using cursor or by file numbers
  87.     - specify a list of files to be displayed for slide shows
  88.     - continuously repeat list of files (for demos etc.)
  89.     - abort single picture or list of pictures in the middle
  90.     - handles corrupt files well
  91.     - returns DOS errorlevel value (useful in batch files and when
  92.       called as a sub-program by other programs)
  93.     - user selectable menu screen colors
  94.  
  95.  
  96. We hope you like our product and decide to register.  Registered users get
  97. VUIMAGE PLUS(tm) Version 2.60, our non-shareware version of the program with
  98. the following added features:
  99.  
  100. - menus may be disabled and file (or files) to be shown may be specified from
  101.   the command line (in this mode, the image may be left on the screen when
  102.   the program ends)
  103.  
  104. - print options may be specified from the command line (you can create a
  105.   batch file easily to "configure" VUIMAGE PLUS(tm)).
  106.  
  107. - compressed bilevel TIFF files (compression type - CCITT Group 3-1D or
  108.   compression type PackBits) can be viewed.  Many scanners come with
  109.   software that can produce such files.
  110.  
  111. REGISTRATION
  112.  
  113. This version of the program is released as shareware. It is not free and is
  114. not in the public domain.  Private, non-commercial users are requested to
  115. register and support its continued development.  To register, please send your
  116. name, address and phone number(s) with the registration fee of US $30.00** to:
  117.  
  118. Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  119.  
  120. Registered users get VUIMAGE PLUS(tm) Ver 2.60 (Outside US, please add $5.00**).
  121.  
  122. Any form of commercial use of VUIMAGE(tm) is strictly prohibited.  Commercial
  123. users should purchase VUIMAGE PLUS(tm), the non-shareware version.  Volume
  124. discounts and site licenses are available for VUIMAGE PLUS(tm).  Contact Offe
  125. Enterprises for customized versions.
  126.  
  127. DISTRIBUTION
  128.  
  129. You may make copies of the program files for VUIMAGE(tm) and the documentation
  130. VUIMG.DOC (this file) together and distribute them to others, upload to
  131. bulletin boards etc. for non-commercial purposes. The program files should
  132. not be distributed without the documentation file VUIMG.DOC.  None of the
  133. files should be modified in any way.  
  134.  
  135. NOTICE
  136.  
  137. This program, and all supporting programs and documentation are provided
  138. "as is" without warranty of any kind, either expressed or implied, including
  139. but not limited to the implied warranties of merchantability and fitness for
  140. a particular purpose.  In no event will Offe Enterprises be liable to you for
  141. any damages arising out of the use or inability to use this program and/or all
  142. supporting programs and documentation.
  143.  
  144. ** All prices and other information are subject to change without notice.
  145.  
  146.  
  147.  
  148. INSTALLATION AND USAGE
  149.  
  150. Note: Requires MS-DOS Version 2.0 or later and at least 150K of free memory.
  151.  
  152. 1.  FLOPPY DISK  Copy all the files from the program disk to another floppy
  153.                  disk.  Use this as your working disk - place this disk into
  154.                  drive A:, type "A:" and press return.  Go to step 2.
  155.  
  156.     HARD DISK    Make a new subdirectory.  For example, if you are using
  157.                  drive C: and the subdirectory name is \VUIMAGE, enter
  158.                           c:
  159.                           md \vuimage
  160.                  Now make this subdirectory your current directory.  In our
  161.                  example, enter
  162.                           cd  \vuimage
  163.                  Copy all the files from the program disk to this subdirectory.
  164.                  Go to step 2.
  165.  
  166. 2.  Now all the files are in the current drive/directory.  To start the program,
  167.     type "vuimg"  at the DOS prompt and press return.
  168.  
  169.     You will be placed in the main menu.  Also shown will be a list of files
  170.     in the current directory that have the extension "GIF".  The current display
  171.     mode will be displayed at the bottom left of the screen.  The main menu
  172.     options are displayed at the bottom right of the screen.
  173.  
  174.     Press "Q" to quit back to DOS.  Go to step 3.
  175.  
  176. 3.  You can execute the program any time by changing to the subdirectory that
  177.     has the program files and typing "vuimg"  as in step 2.  However, it is
  178.     much more convenient to create a "batch file" that will execute the
  179.     program from any directory.  WE RECOMMEND THAT YOU DO THIS so that you
  180.     can "configure" the program this way to suit your own needs.  You can
  181.     create a batch file by typing
  182.  
  183.           copy con: v.bat     <return>
  184.  
  185.     where "v.bat" is the name of the batch file.  Now enter the program
  186.     name along with the drive and directory name.  For example,
  187.  
  188.           c:\vuimage\vuimg    <return>
  189.  
  190.     Then press <ctrl>-Z followed by a <return> to finish creating the batch
  191.     file (you can also use an editor to create this file).  Now you can start
  192.     the program by typing "v" and return.  The batch file need not be kept
  193.     in the same subdirectory as the program files.  However, the sub-directory
  194.     that it is kept in must be part of your "PATH".  The PATH is a list of
  195.     directories that DOS will search when you type in a command.  Refer to
  196.     your DOS manual for information on PATH and how to add a sub-directory to
  197.     your PATH.
  198.  
  199.     After you become familiar with the command line options of the program (see
  200.     later section on command line options), you can re-create the batch file 
  201.     and also specify the command line options that you normally prefer to use.
  202.  
  203.  
  204. MAIN MENU
  205.  
  206. From the main menu, at the "File(s)" prompt, you can enter:
  207.  
  208.         - "t" to select the file type - GIF or TIFF
  209.  
  210.         - "m" to change the display mode
  211.  
  212.         - "s" to change the scaling options
  213.  
  214.         - "o" to change other user selectable options
  215.  
  216.         - "d" to select a different directory/different group of files
  217.  
  218.         - "q" or ESC to quit and go back to DOS.
  219.  
  220.         - a list of picture files to be displayed.  For example, enter
  221.  
  222.                 3,1,5-7,17-14  <return>
  223.  
  224.            to display files 3,1,5,6,7,17,16,15,14 from the list (in that order).
  225.  
  226.         - the up arrow to select files using the cursor keys.  To display a
  227.           single file, move the cursor bar to the file and press enter.  To
  228.           display a list of files, move to each file and press the space bar
  229.           to select (mark) the file.  Press enter to display the marked files
  230.           or "/" to continuously repeat the list of files.  If there are too
  231.           many files to fit on one screen, use the PgUp/PgDn keys to see
  232.           other files.  To get back to the main menu, press the escape key.
  233.  
  234.  
  235.  
  236. SELECTING THE FILE TYPE
  237.  
  238. The default file type is "GIF".  To select between TIFF and GIF, press "t"
  239. at the main menu prompt.  You can also select the file type from the command
  240. line using the "-T" option (for example, -Ttiff will select TIFF - see section
  241. on command line options).
  242.  
  243.  
  244. SETTING THE DISPLAY MODE
  245.  
  246. The program selects a video display mode appropriate for the video adapter
  247. and the picture being displayed automatically.  The mode is chosen from the
  248. CGA/Hercules/EGA/VGA modes present and any modes supported by any extended
  249. mode driver that has been loaded (extended mode drivers are selected by the
  250. command line option "-v" - see section "Display Boards and Extended
  251. Modes/Drivers" for more details on extended modes).
  252.  
  253. If the user desires to select a particular video mode to display the picture
  254. instead of the automatically selected mode, this can be done by pressing
  255. "m" at the main menu prompt, going into the display mode menu and changing
  256. the display mode.  An appropriate mode supported by your video display
  257. board may be specified.  If any extended video mode drivers have been
  258. loaded, the extended modes supported by these drivers are also listed.
  259.  
  260. Instead of using the menu, you can also specify the mode to be used from the
  261. command line by using the "-m" option (for example, "-m7" will use the
  262. EGA 640x350 16-color mode - see section on command line options).
  263.  
  264. There is also a "BIOS" mode that you can use for extended modes that are
  265. unsupported.  Your display board will need to provide complete BIOS support.
  266. Usually the BIOS mode is extremely slow. 
  267.  
  268. If you are using a video mode that has only 2 colors, you can use dithering
  269. to improve the displayed picture.  Use the Options menu to select a type
  270. of dithering to be used for 2-color modes.
  271.  
  272.  
  273. DISPLAYING PICTURE FILES
  274.  
  275. From the main menu, enter the number of the file you wish to display and
  276. press return.  If you wish to display a sequence of files, you can enter
  277. a set of numbers, separated by commas:
  278.  
  279.         Example:  3,5 <return> will display file 3 followed by file 5. 
  280.  
  281. You can enter a starting number and an ending number to display a list of
  282. files:
  283.  
  284.         Example:  2,5-7 <return> will display files 2, 5, 6 and 7.
  285.         Example:  2,7-5 <return> will display files 2, 7, 6 and 5.
  286.  
  287. After you enter a list of files (or one file) and press return, the picture(s)
  288. are displayed in sequence.
  289.  
  290. Alternately, you can press the "up arrow" to select files using the cursor.
  291. To see one file, move the cursor bar to the file and press return.  To
  292. select a list of files, "mark" each file by moving the cursor bar to it
  293. and then pressing space bar.  When you press return, the files will be 
  294. displayed in sequence.
  295.  
  296.  
  297. TIMEOUT
  298.  
  299. Each picture is displayed for a default time of 20 seconds.  Pressing a
  300. return, however, will force the display to end and move on to the next
  301. picture or back to the main menu.  The timeout value can be changed from
  302. the "Options" menu or from the command line using the -t option.
  303.  
  304.  
  305. ABORT PICTURE
  306.  
  307. Pressing the ESC key while a picture is being drawn aborts that picture.
  308. You can abort a list of pictures by pressing the ESC key twice.
  309.  
  310.  
  311. REPEATING LISTS
  312.  
  313. When you enter a list of pictures in the main menu, if you end the list with
  314. the forward slash ("/") instead of a <return>, the list will be continuously
  315. repeated.  To abort this repeated display, press the ESC key twice in quick
  316. succession.
  317.  
  318.  
  319. SELECTING THE DISPLAY DIRECTORY
  320.  
  321. From the main menu, press "d" to change the display directory (the directory
  322. containing the picture files).  The files in this directory will be listed
  323. when you return to the main menu.
  324.  
  325. If only a directory name is specified, all files that have an extension
  326. of GIF or TIF (depending on file type selected) in that directory will be
  327. displayed.  If you want to list other files also, enter an appropriate string
  328. to be matched.
  329.  
  330. Examples:
  331.           To list                                       Enter
  332.  
  333. all files in the current directory                      *.*<return>
  334.  
  335. all files with extension GIF in the current directory   *.gif<return>
  336.  
  337. all files with extension GIF or TIF (depending on       pics<return>
  338.   file type) in the subdirectory "pics" of the
  339.   current directory
  340.  
  341. all files with extension GIF or TIF (depending on       \picdir<return>
  342.   file type) in the subdirectory "picdir" of the
  343.   root directory
  344.  
  345. all files in the subdirectory "picdir" of the root      \picdir\*.*<return>
  346.         directory.
  347.  
  348. You can also set the display directory from the command line using the -d
  349. option.
  350.  
  351.  
  352. SCALING OF PICTURES
  353.  
  354. There are many scaling options. The default scaling is 1:1 i.e. no scaling.
  355. You can choose to set the scales manually.  You can also have the program
  356. perform auto-scaling.  The "auto-scale full screen" option makes the picture
  357. "fit" the screen horizontally and vertically.  You can also auto-scale
  358. with the constraint that the horizontal and vertical scales should be equal.
  359.  
  360. Use the "Scale" menu to change the scaling options.  You can also select
  361. the scaling method from the command line using the -s option.
  362.  
  363.  
  364. ZOOMING
  365.  
  366. Once a picture is displayed on the screen, you can zoom in using the "+" key
  367. and zoom out using the "-" key.
  368.  
  369.  
  370. PANNING
  371.  
  372. Once a picture is displayed on the screen, you can move the viewing window
  373. around the picture by the use of the cursor keypad:
  374.  
  375.                            (Number lock should be disabled)
  376.  
  377.         down arrow  (or "d")       move down  half screen (1/8 screen for TIFF)
  378.         right arrow (or "r")       move right half screen (1/8 screen for TIFF)
  379.         up   arrow  (or "u")       move up    half screen (1/8 screen for TIFF)
  380.         left arrow  (or "l")       move left  half screen (1/8 screen for TIFF)
  381.         "End"       (or "1")       move to bottom left corner
  382.         "PgDn"      (or "3")       move to bottom right corner
  383.         "PgUp"      (or "9")       move to top right corner
  384.         "Home"      (or "7")       move to top left corner
  385.  
  386.                            (Scroll lock should be disabled)
  387.  
  388.   shift-down  arrow (or "2")       move down  full screen
  389.   shift-right arrow (or "6")       move right full screen
  390.   shift-up    arrow (or "8")       move up    full screen
  391.   shift-left  arrow (or "4")       move left  full screen
  392.  
  393.  
  394.  
  395. BRIGHTNESS
  396.  
  397. Once a picture is displayed on the screen, you can increase the brightness
  398. by pressing the "b" key and reduce the brightness by pressing the "B" key.
  399.  
  400.  
  401. PRINTING
  402.  
  403. Once an image is displayed on the screen, you can print that image by
  404. pressing the "p" key.  Before printing, make sure that you have set up
  405. the printer port and selected the correct printer by going into the
  406. Options menu.
  407.  
  408. The entire image is printed.  Any brightness adjustments you have made
  409. will affect the print output.  The output to 2-color printers (most printers)
  410. can be dithered so as to obtain a better print-out.  You can choose between
  411. no dithering, 2x2 dithering, 3x3 dithering or 4x4 dithering by going
  412. into the Options menu.  You may wish to experiment with the dithering
  413. options to obtain the best print image.  For fairly high resolution
  414. printers (200x200 dpi or greater), 3x3 or 4x4 is suggested for paint-type
  415. images, and 1 or 2x2 for line art/scanned documents.
  416.  
  417. From the Options menu, you can also set the desired size of the print-out.
  418.  
  419. You can specify "lpt1:","lpt2:","lpt3:","com1:","com2:" or a filename
  420. for the printer port.
  421.  
  422.  
  423. TEXT SCREEN COLORS
  424.  
  425. You can change the text screen colors used by going into the "Options"
  426. menu and answering "y" when asked "Change Screen Colors ?".
  427. Use the left/right arrow keys to change the foreground color and the
  428. up/down arrow keys to change the background color. (Alternately, you can use
  429. the "f" and "F" keys for foreground and the "b" and "B" keys for background).
  430. Select the colors you like.  Note the numbers shown that corresponds to each
  431. of the colors that you selected - these numbers can be used with the "-cd",
  432. "-co" and the "-cg" command line options to automatically select your
  433. favourite colors when the program is started.
  434.  
  435. ^L
  436.  
  437.  
  438. COMMAND LINE OPTIONS
  439.  
  440. Many of the options may be set from the command line instead going through
  441. a menu.  For example, to start the program with the mode option set to 9
  442. and the scaling option set to 3, enter:
  443.  
  444.         vuimg  -m9 -s3
  445.  
  446. The available command line options are listed below:
  447.  
  448.   -Tfiletype    where filetype is "gif" or "tiff".
  449.                 to go into the "Mode" menu and make a selection.
  450.  
  451.                 Example:   -Ttiff       (display tiff files)
  452.  
  453.   -vdrivername  where drivername is the name of the extended mode driver
  454.                 appropriate for your board.  If the program files are not in
  455.                 the current directory, then the drive and subdirectory must
  456.                 also be specified.
  457.  
  458.                 Example (load ATI VGAWonder driver):
  459.  
  460.                            -vdativ            (program files in current dir)
  461.                            -vc:\vuimage\dativ (program files in c:\vuimage)
  462.  
  463.   -mmodeindex   where modeindex is the number you would enter if you were
  464.                 to go into the "Mode" menu and make a selection.
  465.  
  466.                 Example:   -m9          (set 320x200x256 mode)
  467.  
  468.   -sscaleindex  where scaleindex is the number you would enter if you were
  469.                 to go into the Scale menu (part of the "Options" menu) and
  470.                 make a selection.
  471.  
  472.                 Example:   -s3          (set autoscale full screen)
  473.  
  474.   -sxhscale     where hscale is the horizontal scale value (1% to 999%).
  475.                 This option should be used only if manual scaling is selected.
  476.  
  477.                 Example:   -sx200       (set horizontal scale to 200%)
  478.  
  479.   -syvscale     where vscale is the vertical scale value (1% to 999%).
  480.                 This option should be used only if manual scaling is selected.
  481.  
  482.                 Example:   -sy50        (set vertical scale to 50%)
  483.  
  484.   -ddirectory   where directory is a directory name (or file matching string)
  485.                 that you would enter when you go into the Dir menu.
  486.  
  487.   -ttimeout     where timeout is the number of seconds to display each picture.
  488.  
  489.                 Example:   -t40         (set timeout to 40 seconds)
  490.  
  491.   -by           enables the beep at the end of a picture
  492.   -bn           disables the beep at the end of the picture
  493.  
  494.                 Example:   -bn          (disable beep)
  495.  
  496.   -Bbrightness  where brightness is the brightness value (100 is nominal)
  497.  
  498.                 Example:   -B120                (set brightness to 120%)
  499.  
  500.   -cddircolor   where dircolor is the color number for the filenames 
  501.   -cofncolor          fncolor  is the color number for the file numbers 
  502.   -cmmodcolor         modcolor is the color number for the display mode
  503.   -cggencolor         gencolor is the color number for general text
  504.                 To find the color numbers for the colors of your choice, first
  505.                 go into the "Options" menu and select the colors that you like.
  506.                 The corresponding color numbers are also displayed.
  507.  
  508.                 Example:   -cd78    (filenames in yellow on a red background)
  509.                            -co10    (filenumbers in bright green on black)
  510.                            -cm4     (video mode in red on black)
  511.                            -cg14    (general text in yellow on black)
  512.  
  513. (*** The following options are available only in VUIMAGE PLUS(tm) ***)
  514.  
  515.   -pdprinternum where printernum is the number you would enter if you were
  516.                 to go into the Options menu and choose a printer.
  517.  
  518.                 Example:   -p1      (select EPSON FX80/100 printer)
  519.  
  520.   -pddevicename where devicename is the printer device (lpt1:, lpt2:, lpt3:,
  521.                 com1:, com2: or filename).
  522.  
  523.                 Example:   -pdlpt1:      (send output to lpt1:)
  524.                            -pdvuimg.prn  (send output to file vuimg.prn)
  525.  
  526.   -pxwidth      where width is the width of the printed image in 1/100 inches
  527.  
  528.                 Example:   -px904   (print image width=9.04 inches)
  529.  
  530.   -pyheight     where height is the height of the printed image in 1/100 inches
  531.  
  532.                 Example:   -py1200  (print image height=12.00 inches)
  533.  
  534.   -fddithertype where dithertype is the number you would enter if you were to
  535.                 go into the Options menu and choose the display dither type.
  536.  
  537.                 Example:   -fd3     (dither 2-color displays using 3x3 matrix)
  538.  
  539.   -fpdithertype where dithertype is the number you would enter if you were to
  540.                 go into the Options menu and choose the printer dither type.
  541.  
  542.                 Example:   -fd4     (dither 2-color printers using 4x4 matrix)
  543.  
  544.   -C            disables the menus.  If you use this option, you must also
  545.                 specify a filename to be displayed including the pathname.
  546.                 This should be the last option entered on the command line.
  547.                 The filename may contain wild card characters ? and * and 
  548.                 should be the last parameter.  Any directory name entered
  549.                 with the -d option will be ignored.
  550.  
  551.                 Examples:   -C somefile.gif
  552.                             -C \pics\*.gif
  553.  
  554.   -L            leave the last image on the screen when the program ends.
  555.                 Valid only when the -C option is used.  Useful when called
  556.                 as a sub-program by another program.
  557.  
  558.  
  559.  
  560.  
  561. PRE-PROGRAMMED MODE
  562.  
  563. You can run the program in a PRE-PROGRAMMED mode where it will go through a
  564. display session with no keyboard input.  To do this, go through a manual
  565. session and write down all keystrokes till you quit back to DOS (this is
  566. important).  If you use the ESC key to abort a picture or list,
  567. the return key to move on to the next picture, or the cursor keys to do
  568. panning, do NOT include these keystrokes.  Then create a file containing
  569. these keystrokes (we will use the filename "vuimg.inp" in the following
  570. example).  To do this, type: 
  571.  
  572.         copy con: vuimg.inp <return>
  573.  
  574. Enter the keystrokes you wrote down and then type a <CTRL>Z to create the
  575. file called vuimg.inp.  A text editor (ex. edlin) may also be used to
  576. create such a file (start a new line for every "return" key).  This file
  577. may then be used to run the program in the PRE-PROGRAMMED mode by typing
  578.  
  579.        vuimg  < vuimg.inp
  580.  
  581.  
  582. DOS EXIT CODES (ERRORLEVEL)
  583. ---------------------------
  584.  
  585. The return codes generated by the program that may be tested in a batch
  586. file are:
  587.  
  588. 0 - no error
  589. 1 - command line option error
  590. 2 - the -C option was used without specifying a file
  591. 3 - file not found or invalid filename
  592.  
  593.  
  594.  
  595.  
  596. DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS
  597. -----------------------------------------------
  598.  
  599. If the program does not work with your display board, try loading any software
  600. drivers (BIOS emulators, int 10h drivers, RAM BIOS drivers) that come with it.
  601. Refer to the instructions that come with your graphics board.
  602.  
  603. Some video display boards support even higher resolutions than standard VGA,
  604. for example, 640x480 in 256 colors and 800x600 in 16 colors.  These are
  605. sometimes referred to as SuperVGA modes.  Additional drivers that support
  606. these "extended modes" are included with the program.  These drivers are listed
  607. later in this section and can be loaded using the "-v" command line option
  608. (see section on command line options).
  609.  
  610. Extended modes are dependent on your type of graphics board.  Refer to your
  611. graphics board manual to see what additional modes are supported.  Only VGA type
  612. extended modes with either 16 or 256 colors out of a palette of 262,144
  613. colors are supported by the drivers.
  614.  
  615. If you are not using any extended drivers, you may still be able to display
  616. in an extended mode if your BIOS for the board will support this.  Not all
  617. boards come with BIOS that support the extended modes completely.  Installing
  618. any RAM BIOS drivers that come with your board may help.  Display done
  619. through the BIOS is usually extremely slow.
  620.  
  621. To use the BIOS supported extended modes, you need to know the mode number,
  622. the no. of columns, the no. of rows, and the no. of colors for the mode.
  623. Refer to the manual for your graphics card.
  624.  
  625.  
  626. Extended Mode Drivers (SuperVGA drivers) included:
  627.  
  628.     If your display board is:                   Try driver
  629.     ------------------------                    ----------
  630.         ATI VGAWONDER                           DATIV
  631.         Paradise VGA cards                      DPVGA
  632.         AST VGA cards                           DPVGA
  633.         AT&T VDC600                             DPVGA
  634.         Orchid ProDesigner                      DORCH
  635.         STB VGA cards                           DORCH
  636.         Genoa VGA cards                         DORCH
  637.         Sigma VGA cards                         DORCH
  638.         Standard IBM VGA & register compatibles
  639.                 with multisync monitors         DNVGA
  640.         Everex EV673                            DE673
  641.         Everex EV678                            DE678
  642.         Video-7 Fastwrite                       DV7FW
  643.         Video-7 1024i                           DV71024
  644.         Video-7 VRAM                            DV7VRAM
  645.         Trident Video cards                     DTRID
  646.  
  647.  
  648.     If your board is not listed, you can try one of the supplied drivers
  649.     to see if any of the extended modes will work. Other drivers may become
  650.     available from Offe in the future.  Not all modes available are supported
  651.     on the listed boards.
  652.  
  653.  
  654. Extended Modes Supported by the Drivers (mode numbers in decimal and hex)
  655.  
  656. DATIV
  657.         Mode  84 (54h)           800 x 600 x  16 colors 
  658.         Mode  97 (61h)           640 x 400 x 256 colors
  659.         Mode  98 (62h)           640 x 480 x 256 colors
  660.         Mode  99 (63h)           800 x 600 x 256 colors
  661.         Mode 101 (65h)          1024 x 768 x  16 colors
  662.  
  663. DE673
  664.         Submode 19 (13h)        640 x 350 x 256 colors
  665.         Submode 20 (14h)        640 x 400 x 256 colors
  666.         Submode 21 (15h)        512 x 480 x 256 colors
  667.  
  668. DE678
  669.         Submode 49 (31h)        640 x 400 x 256 colors
  670.         Submode 50 (32h)        512 x 480 x 256 colors
  671.         Submode 77 (4dh)        640 x 480 x 256 colors
  672.         Submode 78 (4eh)        800 x 600 x 256 colors
  673.  
  674. DNVGA
  675.         -------                  320 x 400 x 256 colors
  676.         -------                  360 x 480 x 256 colors
  677.         -------                  800 x 600 x  16 colors
  678.  
  679. DORCH
  680.         Mode  41 (29h)           800 x 600 x  16 colors
  681.         Mode  45 (2Dh)           640 x 350 x 256 colors
  682.         Mode  46 (2Eh)           640 x 480 x 256 colors
  683.         Mode  47 (2Fh)           720 x 512 x 256 colors
  684.         Mode  48 (30h)           800 x 600 x 256 colors
  685.         Mode  55 (37h)          1024 x 768 x  16 colors
  686.  
  687. DPVGA
  688.         Mode  88 (58h)           800 x 600 x  16 colors
  689.         Mode  94 (5Eh)           640 x 400 x 256 colors
  690.         Mode  95 (5Fh)           640 x 480 x 256 colors
  691.  
  692. DV7FW
  693.         Mode  98 (62h)           800 x 600 x  16 colors
  694.         Mode 102 (66h)           640 x 400 x 256 colors
  695.         Mode 103 (67h)           640 x 480 x 256 colors
  696.  
  697. DTRID
  698.         Mode  91 (5Bh)           800 x 600 x  16 colors
  699.         Mode  92 (5Ch)           640 x 400 x 256 colors
  700.         Mode  93 (5Dh)           640 x 480 x 256 colors
  701.         Mode  95 (5Fh)          1024 x 768 x  16 colors
  702.  
  703. DV71024
  704.         Mode  98 (62h)           800 x 600 x  16 colors
  705.         Mode 101 (65h)          1024 x 768 x  16 colors
  706.         Mode 102 (66h)           640 x 400 x 256 colors
  707.         Mode 103 (67h)           640 x 480 x 256 colors
  708.  
  709. DV7VRAM
  710.         Mode  98 (62h)           800 x 600 x  16 colors
  711.         Mode 101 (65h)          1024 x 768 x  16 colors
  712.         Mode 102 (66h)           640 x 400 x 256 colors
  713.         Mode 103 (67h)           640 x 480 x 256 colors
  714.         Mode 105 (69h)           800 x 600 x 256 colors
  715.